<!DOCTYPE html>
<html>
<head>
<title>S2JH4Net_Guide</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<style type="text/css">
/* GitHub stylesheet for MarkdownPad (http://markdownpad.com) */
/* Author: Nicolas Hery - http://nicolashery.com */
/* Version: b13fe65ca28d2e568c6ed5d7f06581183df8f2ff */
/* Source: https://github.com/nicolahery/markdownpad-github */

/* RESET
=============================================================================*/

html, body, div, span, applet, object, iframe, h1, h2, h3, h4, h5, h6, p, blockquote, pre, a, abbr, acronym, address, big, cite, code, del, dfn, em, img, ins, kbd, q, s, samp, small, strike, strong, sub, sup, tt, var, b, u, i, center, dl, dt, dd, ol, ul, li, fieldset, form, label, legend, table, caption, tbody, tfoot, thead, tr, th, td, article, aside, canvas, details, embed, figure, figcaption, footer, header, hgroup, menu, nav, output, ruby, section, summary, time, mark, audio, video {
  margin: 0;
  padding: 0;
  border: 0;
}

/* BODY
=============================================================================*/

body {
  font-family: Helvetica, arial, freesans, clean, sans-serif;
  font-size: 14px;
  line-height: 1.6;
  color: #333;
  background-color: #fff;
  padding: 20px;
  max-width: 960px;
  margin: 0 auto;
}

body>*:first-child {
  margin-top: 0 !important;
}

body>*:last-child {
  margin-bottom: 0 !important;
}

/* BLOCKS
=============================================================================*/

p, blockquote, ul, ol, dl, table, pre {
  margin: 15px 0;
}

/* HEADERS
=============================================================================*/

h1, h2, h3, h4, h5, h6 {
  margin: 20px 0 10px;
  padding: 0;
  font-weight: bold;
  -webkit-font-smoothing: antialiased;
}

h1 tt, h1 code, h2 tt, h2 code, h3 tt, h3 code, h4 tt, h4 code, h5 tt, h5 code, h6 tt, h6 code {
  font-size: inherit;
}

h1 {
  font-size: 28px;
  color: #000;
}

h2 {
  font-size: 24px;
  border-bottom: 1px solid #ccc;
  color: #000;
}

h3 {
  font-size: 18px;
}

h4 {
  font-size: 16px;
}

h5 {
  font-size: 14px;
}

h6 {
  color: #777;
  font-size: 14px;
}

body>h2:first-child, body>h1:first-child, body>h1:first-child+h2, body>h3:first-child, body>h4:first-child, body>h5:first-child, body>h6:first-child {
  margin-top: 0;
  padding-top: 0;
}

a:first-child h1, a:first-child h2, a:first-child h3, a:first-child h4, a:first-child h5, a:first-child h6 {
  margin-top: 0;
  padding-top: 0;
}

h1+p, h2+p, h3+p, h4+p, h5+p, h6+p {
  margin-top: 10px;
}

/* LINKS
=============================================================================*/

a {
  color: #4183C4;
  text-decoration: none;
}

a:hover {
  text-decoration: underline;
}

/* LISTS
=============================================================================*/

ul, ol {
  padding-left: 30px;
}

ul li > :first-child, 
ol li > :first-child, 
ul li ul:first-of-type, 
ol li ol:first-of-type, 
ul li ol:first-of-type, 
ol li ul:first-of-type {
  margin-top: 0px;
}

ul ul, ul ol, ol ol, ol ul {
  margin-bottom: 0;
}

dl {
  padding: 0;
}

dl dt {
  font-size: 14px;
  font-weight: bold;
  font-style: italic;
  padding: 0;
  margin: 15px 0 5px;
}

dl dt:first-child {
  padding: 0;
}

dl dt>:first-child {
  margin-top: 0px;
}

dl dt>:last-child {
  margin-bottom: 0px;
}

dl dd {
  margin: 0 0 15px;
  padding: 0 15px;
}

dl dd>:first-child {
  margin-top: 0px;
}

dl dd>:last-child {
  margin-bottom: 0px;
}

/* CODE
=============================================================================*/

pre, code, tt {
  font-size: 12px;
  font-family: Consolas, "Liberation Mono", Courier, monospace;
}

code, tt {
  margin: 0 0px;
  padding: 0px 0px;
  white-space: nowrap;
  border: 1px solid #eaeaea;
  background-color: #f8f8f8;
  border-radius: 3px;
}

pre>code {
  margin: 0;
  padding: 0;
  white-space: pre;
  border: none;
  background: transparent;
}

pre {
  background-color: #f8f8f8;
  border: 1px solid #ccc;
  font-size: 13px;
  line-height: 19px;
  overflow: auto;
  padding: 6px 10px;
  border-radius: 3px;
}

pre code, pre tt {
  background-color: transparent;
  border: none;
}

kbd {
    -moz-border-bottom-colors: none;
    -moz-border-left-colors: none;
    -moz-border-right-colors: none;
    -moz-border-top-colors: none;
    background-color: #DDDDDD;
    background-image: linear-gradient(#F1F1F1, #DDDDDD);
    background-repeat: repeat-x;
    border-color: #DDDDDD #CCCCCC #CCCCCC #DDDDDD;
    border-image: none;
    border-radius: 2px 2px 2px 2px;
    border-style: solid;
    border-width: 1px;
    font-family: "Helvetica Neue",Helvetica,Arial,sans-serif;
    line-height: 10px;
    padding: 1px 4px;
}

/* QUOTES
=============================================================================*/

blockquote {
  border-left: 4px solid #DDD;
  padding: 0 15px;
  color: #777;
}

blockquote>:first-child {
  margin-top: 0px;
}

blockquote>:last-child {
  margin-bottom: 0px;
}

/* HORIZONTAL RULES
=============================================================================*/

hr {
  clear: both;
  margin: 15px 0;
  height: 0px;
  overflow: hidden;
  border: none;
  background: transparent;
  border-bottom: 4px solid #ddd;
  padding: 0;
}

/* TABLES
=============================================================================*/

table th {
  font-weight: bold;
}

table th, table td {
  border: 1px solid #ccc;
  padding: 6px 13px;
}

table tr {
  border-top: 1px solid #ccc;
  background-color: #fff;
}

table tr:nth-child(2n) {
  background-color: #f8f8f8;
}

/* IMAGES
=============================================================================*/

img {
  max-width: 100%
}
</style>
<style type="text/css">
.highlight  { background: #ffffff; }
.highlight .c { color: #999988; font-style: italic } /* Comment */
.highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */
.highlight .k { font-weight: bold } /* Keyword */
.highlight .o { font-weight: bold } /* Operator */
.highlight .cm { color: #999988; font-style: italic } /* Comment.Multiline */
.highlight .cp { color: #999999; font-weight: bold } /* Comment.Preproc */
.highlight .c1 { color: #999988; font-style: italic } /* Comment.Single */
.highlight .cs { color: #999999; font-weight: bold; font-style: italic } /* Comment.Special */
.highlight .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */
.highlight .gd .x { color: #000000; background-color: #ffaaaa } /* Generic.Deleted.Specific */
.highlight .ge { font-style: italic } /* Generic.Emph */
.highlight .gr { color: #aa0000 } /* Generic.Error */
.highlight .gh { color: #999999 } /* Generic.Heading */
.highlight .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */
.highlight .gi .x { color: #000000; background-color: #aaffaa } /* Generic.Inserted.Specific */
.highlight .go { color: #888888 } /* Generic.Output */
.highlight .gp { color: #555555 } /* Generic.Prompt */
.highlight .gs { font-weight: bold } /* Generic.Strong */
.highlight .gu { color: #aaaaaa } /* Generic.Subheading */
.highlight .gt { color: #aa0000 } /* Generic.Traceback */
.highlight .kc { font-weight: bold } /* Keyword.Constant */
.highlight .kd { font-weight: bold } /* Keyword.Declaration */
.highlight .kp { font-weight: bold } /* Keyword.Pseudo */
.highlight .kr { font-weight: bold } /* Keyword.Reserved */
.highlight .kt { color: #445588; font-weight: bold } /* Keyword.Type */
.highlight .m { color: #009999 } /* Literal.Number */
.highlight .s { color: #d14 } /* Literal.String */
.highlight .na { color: #008080 } /* Name.Attribute */
.highlight .nb { color: #0086B3 } /* Name.Builtin */
.highlight .nc { color: #445588; font-weight: bold } /* Name.Class */
.highlight .no { color: #008080 } /* Name.Constant */
.highlight .ni { color: #800080 } /* Name.Entity */
.highlight .ne { color: #990000; font-weight: bold } /* Name.Exception */
.highlight .nf { color: #990000; font-weight: bold } /* Name.Function */
.highlight .nn { color: #555555 } /* Name.Namespace */
.highlight .nt { color: #000080 } /* Name.Tag */
.highlight .nv { color: #008080 } /* Name.Variable */
.highlight .ow { font-weight: bold } /* Operator.Word */
.highlight .w { color: #bbbbbb } /* Text.Whitespace */
.highlight .mf { color: #009999 } /* Literal.Number.Float */
.highlight .mh { color: #009999 } /* Literal.Number.Hex */
.highlight .mi { color: #009999 } /* Literal.Number.Integer */
.highlight .mo { color: #009999 } /* Literal.Number.Oct */
.highlight .sb { color: #d14 } /* Literal.String.Backtick */
.highlight .sc { color: #d14 } /* Literal.String.Char */
.highlight .sd { color: #d14 } /* Literal.String.Doc */
.highlight .s2 { color: #d14 } /* Literal.String.Double */
.highlight .se { color: #d14 } /* Literal.String.Escape */
.highlight .sh { color: #d14 } /* Literal.String.Heredoc */
.highlight .si { color: #d14 } /* Literal.String.Interpol */
.highlight .sx { color: #d14 } /* Literal.String.Other */
.highlight .sr { color: #009926 } /* Literal.String.Regex */
.highlight .s1 { color: #d14 } /* Literal.String.Single */
.highlight .ss { color: #990073 } /* Literal.String.Symbol */
.highlight .bp { color: #999999 } /* Name.Builtin.Pseudo */
.highlight .vc { color: #008080 } /* Name.Variable.Class */
.highlight .vg { color: #008080 } /* Name.Variable.Global */
.highlight .vi { color: #008080 } /* Name.Variable.Instance */
.highlight .il { color: #009999 } /* Literal.Number.Integer.Long */
.pl-c {
    color: #969896;
}

.pl-c1,.pl-mdh,.pl-mm,.pl-mp,.pl-mr,.pl-s1 .pl-v,.pl-s3,.pl-sc,.pl-sv {
    color: #0086b3;
}

.pl-e,.pl-en {
    color: #795da3;
}

.pl-s1 .pl-s2,.pl-smi,.pl-smp,.pl-stj,.pl-vo,.pl-vpf {
    color: #333;
}

.pl-ent {
    color: #63a35c;
}

.pl-k,.pl-s,.pl-st {
    color: #a71d5d;
}

.pl-pds,.pl-s1,.pl-s1 .pl-pse .pl-s2,.pl-sr,.pl-sr .pl-cce,.pl-sr .pl-sra,.pl-sr .pl-sre,.pl-src,.pl-v {
    color: #df5000;
}

.pl-id {
    color: #b52a1d;
}

.pl-ii {
    background-color: #b52a1d;
    color: #f8f8f8;
}

.pl-sr .pl-cce {
    color: #63a35c;
    font-weight: bold;
}

.pl-ml {
    color: #693a17;
}

.pl-mh,.pl-mh .pl-en,.pl-ms {
    color: #1d3e81;
    font-weight: bold;
}

.pl-mq {
    color: #008080;
}

.pl-mi {
    color: #333;
    font-style: italic;
}

.pl-mb {
    color: #333;
    font-weight: bold;
}

.pl-md,.pl-mdhf {
    background-color: #ffecec;
    color: #bd2c00;
}

.pl-mdht,.pl-mi1 {
    background-color: #eaffea;
    color: #55a532;
}

.pl-mdr {
    color: #795da3;
    font-weight: bold;
}

.pl-mo {
    color: #1d3e81;
}
.task-list {
padding-left:10px;
margin-bottom:0;
}

.task-list li {
    margin-left: 20px;
}

.task-list-item {
list-style-type:none;
padding-left:10px;
}

.task-list-item label {
font-weight:400;
}

.task-list-item.enabled label {
cursor:pointer;
}

.task-list-item+.task-list-item {
margin-top:3px;
}

.task-list-item-checkbox {
display:inline-block;
margin-left:-20px;
margin-right:3px;
vertical-align:1px;
}
</style>
</head>
<body>
<h1 id="-nutch-solr-">基于Nutch&amp;Solr定向采集解析和索引搜索的整合技术指南文档</h1>
<h2 id="-">如何阅读本文档</h2>
<p>本教程文档原始基于Markdown编写，如果你熟悉Markdown文件及相关工具使用，可以直接通过Markdown阅读或编辑工具查看本教程.md格式文件。</p>
<p>由于Markdown语法暂时没有目录支持，如果希望以目录导航方式查看文档，可参考如下方式：在文档对应的.html格式文件上面右键选择“Open with Microsoft Office Word”或直接用Word打开此文件，开启“文档结构视图”功能，显示文档内容模式大致如下：</p>
<p><img src="images/img-0000.jpg" alt="img"></p>
<h2 id="-">总体介绍</h2>
<h3 id="-">文档内容说明</h3>
<p>文档内容主要涉及基于 <a href="http://git.oschina.net/xautlx/s2jh4net">http://git.oschina.net/xautlx/s2jh4net</a> 项目内容的设计和开发过程讲解。具体可详见文档目录列表。</p>
<h3 id="-">主要功能特性</h3>
<p>TODO</p>
<h3 id="-">主要技术特性</h3>
<p>TODO</p>
<h3 id="-">特别说明</h3>
<ul>
<li><p>文档所列举到的工具软件类型及版本，操作过程等，皆以实际操作过程涉及相关为参考，如果你是新手建议一步步按照文档进行，如果你是熟手你可以参考相关描述直接在现有熟悉的环境自行配置。</p>
</li><li><p>除特殊说明以外，以下教程假定相关软件或项目的操作根目录为：DEV_DIR=D:\projects\training\s2jh4net，另外，<strong>部分截图来源于其他项目内容，请注意参考本教程相关描述对应调整</strong>。</p>
</li></ul>
<p><strong>内容不包括：</strong></p>
<p>TODO</p>
<h2 id="-">基本工具安装配置</h2>
<h3 id="jdk-">JDK版本及安装</h3>
<p>从Oracle官方下载JDK 7版本，本教程采用Windows 64位jdk1.7.0_45。默认安装路径为：C:\Program Files\Java\jdk1.7.0_45</p>
<h3 id="eclipse-ide-spring-tool-suite">Eclipse IDE / Spring Tool Suite</h3>
<p>本教程采用Windows 64位spring-tool-suite 3.6.3.RELEASE（以下简称STS），下载安装文件名为 spring-tool-suite-3.6.3.RELEASE-e4.4.1-win32-x86_64.zip。<br>具体可访问 <a href="http://spring.io/tools/sts/">http://spring.io/tools/sts/</a>  或   <a href="http://spring.io/tools/sts/legacy">http://spring.io/tools/sts/legacy</a>  下载STS最新版本或本教程对应版本。</p>
<p>下载压缩文件后，创建${DEV_DIR}\tools目录，并把zip文件直接拷贝到tools目录，然后点击右键解压缩工具（本教程使用7-zip工具）“解压缩到当前文件夹...”，得到本地${DEV_DIR}\tools\sts-bundle。</p>
<p><strong>重要提示：</strong>建议不要采用直接双击打开压缩包然后拖放到目录的操作方式，而是通过解压软件的右键菜单直接选取“解压到当前文件夹”方式，否则在Windows环境下很可能遇到抛出文件路径过长的错误。</p>
<p><img src="images/img-0054.jpg" alt="img"></p>
<p>即便通过直接解压的方式，也可能出现如下类似路径过程的错误，可以忽略，不影响IDE的功能使用：</p>
<pre><code>!   D:\projects\training\s2jh4net\tools\spring-tool-suite-3.6.3.RELEASE-e4.4.1-win32-x86_64.zip: 
无法创建 sts-bundle\sts-3.6.3.RELEASE\plugins\org.springsource.ide.eclipse.commons.gettingstarted_3.6.3.201411271001-RELEASE
\org\springsource\ide\eclipse\commons\gettingstarted\dashboard\ExtensionsEditor$DashboardDiscoveryViewer.class
    路径和文件名总长度必须不能超过 260 个字符
</code></pre><h3 id="apache-maven-">Apache Maven安装配置</h3>
<p>目前框架和教程实际验证过的采用apache-maven-3.0.5版本，按照官方的说法 “This is a stable version 3.0.x of Maven for projects that can&#39;t upgrade to Maven 3.2 yet.” ，其他Maven版本可能存在位置的兼容性问题。具体可访问 <a href="http://maven.apache.org/download.cgi">http://maven.apache.org/download.cgi</a> 下载3.0.5版本。</p>
<p>下载后如下图路径解压目录，${DEV_DIR}\tools\apache-maven-3.0.5：</p>
<p><img src="images/img-0053.jpg" alt="img"></p>
<p>然后是本地资源库配置（提示：如果你熟悉Maven的使用并且本地已经有自己的本地资源库目录，则直接指向已有目录即可），首先在系统资源管理器操作创建本地资源库目录：${DEV_DIR}\tools\repository，然后编辑settings.xml配置文件设置Maven本地资源库目录，取消注释并设定：</p>
<pre><code>&lt;localRepository&gt;D:\projects\training\s2jh4net\tools\repository&lt;/localRepository&gt;
</code></pre><h3 id="eclipse-">Eclipse 插件安装配置</h3>
<p>启动STS（${DEV_DIR}\tools\sts-bundle\sts-3.6.3.RELEASE\STS.exe），设定工作空间为${DEV_DIR}\workspace，切换到Java EE视图。</p>
<p><img src="images/img-0001.jpg" alt="STS"></p>
<p>除以下提到的一些功能性设定以外，相关的界面布局，样式等可以根据个人喜好自行设定。</p>
<h4 id="jdk-">JDK设置</h4>
<p>STS默认取安装的jre，一般建议添加配置执行本地安装的jdk，如下图配置所示：</p>
<p><img src="images/img-0015.jpg" alt="JDK"></p>
<h4 id="apache-maven-">Apache Maven配置</h4>
<p>如下图打开选项配置界面，选择“Add...”按钮：</p>
<p><img src="images/img-0055.jpg" alt="img"></p>
<p>如下图浏览定位到上述安装Maven3.0.5目录，${DEV_DIR}\tools\apache-maven-3.0.5：</p>
<p><img src="images/img-0056.jpg" alt="img"></p>
<p>最后勾选新增的Maven配置项，点击Apply或OK：</p>
<p><img src="images/img-0057.jpg" alt="img"></p>
<p>再如下图切换到“Maven”-》“User Settings”配置，浏览设定“Global Setting”到目录文件：D:\projects\training\s2jh4net\tools\apache-maven-3.0.5\conf\settings.xml，然后点击“Update Settings”按钮触发更新本地资源库目录定义：</p>
<p><img src="images/img-0004.jpg" alt="img"></p>
<h4 id="lombok-">Lombok插件安装配置</h4>
<p>实体对象属性定义采用了Lombok来简化繁琐的getter和setter定义，所以java源码层面就没有相关的getter和setter方法定义，因此需要安装Lombok的Eclipse插件来实现自动化增强编译输出缺少的方法定义，否则整个工程会抛出编译错误。</p>
<p>打开工程项目\doc\resources目录下的lombok-x.x.x.jar（或从 <a href="http://projectlombok.org/download.html">http://projectlombok.org/download.html</a> 直接下载最新版本亦可），注意以java -jar运行模式打开，如下图：</p>
<p><img src="images/img-0005.jpg" alt="img"></p>
<p>在如下程序界面定位到STS IDE目录，最后点击“Install / Update”安装插件：</p>
<p><img src="images/img-0010.jpg" alt="img"></p>
<p>最后查看IDE的启动配置文件确认安装成功，如果有自行配置vm参数的请自行参考添加设置对应格式的参数即可：</p>
<p><img src="images/img-0058.jpg" alt="img"></p>
<h4 id="eclipse-workspace-">Eclipse Workspace参数配置</h4>
<ul>
<li>编码设定为UTF-8，如下图：</li></ul>
<p><img src="images/img-0020.jpg" alt="core.autocrlf"></p>
<ul>
<li>为了开发效率，个人一般屏蔽IDE的所有Validation或根据需要保留个别，如下图：</li></ul>
<p><img src="images/img-0060.jpg" alt="img"></p>
<h2 id="-">项目资源库获取说明</h2>
<p>项目基于GIT进行代码托管，你可以基于熟悉的Eclipse Git插件或TortoiseGIT或其他GIT客户端工具等获取项目代码。以下基于STS已自带的git插件进行项目获取。</p>
<p>启动STS，菜单操作Window-》Show View-》Others，在弹出界面找到Git-》Git Repositories：</p>
<p><img src="images/img-0006.jpg" alt="Git Repositories"></p>
<p>再显示的“Git Repositories”标签项，选择“Clone a Git Repository”，弹出界面选择“Clone URI”，</p>
<p><img src="images/img-0008.jpg" alt="Git Repositories"></p>
<p>输入项目git资源库地址：<a href="https://git.oschina.net/xautlx/s2jh4net.git">https://git.oschina.net/xautlx/s2jh4net.git</a>  ，填写自己的git平台网站的账号和密码：</p>
<p><img src="images/img-0006.jpg" alt="Git Repositories"></p>
<p>下一步选取所需的代码分支，默认master。一般master是项目主干最新代码，具体其他各分支用途详见后续说明。</p>
<p>下一步填写资源库的存储路径，本教程为：D:\projects\training\s2jh4net\s2jh4net。</p>
<p><img src="images/img-0009.jpg" alt="Git Repositories"></p>
<h2 id="-">项目导入及开发环境配置</h2>
<p><strong>重要提示：</strong>最好在上述Eclipse配置完成后再按照下述过程导入项目，避免不必要的环境配置问题导致编译异常。</p>
<h3 id="-sts-">项目导入STS工作空间</h3>
<p>git插件clone下载整个工程目录后，在STS的Project Explorer鼠标右键点击“Import” -》“Import...”：</p>
<p><img src="images/img-0011.jpg" alt="Import"></p>
<p><img src="images/img-0012.jpg" alt="Import"></p>
<p>定位到：D:\projects\training\s2jh4net\s2jh4net，选择项目，然后完成导入操作：</p>
<p><img src="images/img-0013.jpg" alt="Import"></p>
<p>导入项目后STS应该会自动触发项目构建，同时进行Maven依赖资源的下载，此过程依据你的网速情况可能需要持续数分钟到数十分钟。在初始化自动构建完毕后，为了确保Maven执行的完整性，建议在项目的pom.xml文件上面右键执行maven install命令，如下图，正常情况能看到项目构建和单元测试运行等过程：</p>
<p><img src="images/img-0059.jpg" alt="img"></p>
<p>最后，如果项目依然有编译错误，请尝试对项目进行clean操作，然后refresh整个工作空间。直至整个项目没有编译错误。</p>
<p><img src="images/img-0061.jpg" alt="img"></p>
<h3 id="-server-">项目部署到Server运行</h3>
<p>将Web项目部署到Eclipse STS自带的Server下面，然后选择Start启动服务，项目默认配置采用H2内存数据库，可以直接启动运行：</p>
<p><img src="images/img-0062.jpg" alt="img"></p>
<p>Console台可以看到整个数据库结构及基础数据初始化过程，最后出现如下界面：</p>
<p><img src="images/img-0063.jpg" alt="img"></p>
<p>最后打开浏览器，访问 <a href="http://localhost:8080/s2jh4net">http://localhost:8080/s2jh4net</a> ，出现默认前端首页界面， 目前 前端Web站点 | HTML5移动站点 仅作站点布局展示，暂无太多功能实现，主要原型演示请访问： <a href="http://localhost:8080/s2jh4net/admin">http://localhost:8080/s2jh4net/admin</a> ,admin登录界面直接点击右下方的“admin超级管理员”登录链接即可。正常情况即可正常进入管理端主界面。</p>
<p><img src="images/img-0064.jpg" alt="img"></p>
<p><img src="images/img-0065.jpg" alt="img"></p>
<p><img src="images/img-0066.jpg" alt="img"></p>
<h3 id="-mysql-">关于MySQL运行配置说明</h3>
<p>TODO</p>

</body>
</html>
<!-- This document was created with MarkdownPad, the Markdown editor for Windows (http://markdownpad.com) -->
